home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pg.z / pg
Text File  |  1998-10-20  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4. ppppgggg((((1111))))                                                                    ppppgggg((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_gggg - file perusal filter for CRTs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _pppp_gggg [ -_n_u_m_b_e_r ] [ _----_pppp _s_t_r_i_n_g ] [ _----_cccc_eeee_ffff_nnnn_rrrr_ssss ] [ _++++_l_i_n_e_n_u_m_b_e_r ] [ _++++_////_p_a_t_t_e_r_n_//// ] [
  13.      _f_i_l_e . . .  ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _pppp_gggg command is a filter that allows the examination of _f_i_l_e_s one
  17.      screenful at a time on a CRT.  (If no _f_i_l_e is specified or if it
  18.      encounters the file name _----, _pppp_gggg reads from standard input.)  Each
  19.      screenful is followed by a prompt.  If the user types a carriage return,
  20.      another page is displayed; other possibilities are listed below.  _pppp_gggg
  21.      processes supplementary code set characters in _f_i_l_e_s, and recognizes
  22.      supplementary code set characters in the _s_t_r_i_n_g given to the _----_pppp option
  23.      (see below) according to the locale specified in the _LLLL_CCCC______CCCC_TTTT_YYYY_PPPP_EEEE environment
  24.      variable [see _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)].  In regular expressions, pattern
  25.      searches are performed on characters, not bytes, as described on _eeee_dddd(1).
  26.  
  27.      This command is different from previous paginators in that it allows you
  28.      to back up and review something that has already passed.  The method for
  29.      doing this is explained below.
  30.  
  31.      To determine terminal attributes, _pppp_gggg scans the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4) data base for
  32.      the terminal type specified by the environment variable _TTTT_EEEE_RRRR_MMMM.  If _TTTT_EEEE_RRRR_MMMM is
  33.      not defined, the terminal type _dddd_uuuu_mmmm_bbbb is assumed.
  34.  
  35.      The command line options are:
  36.  
  37.      -_n_u_m_b_e_r
  38.           An integer specifying the size (in lines) of the window that _pppp_gggg is
  39.           to use instead of the default.  (On a terminal containing 24 lines,
  40.           the default window size is 23).
  41.  
  42.      _----_cccc   Home the cursor and clear the screen before displaying each page.
  43.           This option is ignored if _cccc_llll_eeee_aaaa_rrrr______ssss_cccc_rrrr_eeee_eeee_nnnn is not defined for this
  44.           terminal type in the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4) data base.
  45.  
  46.      _----_eeee   Causes _pppp_gggg not to pause at the end of each file.
  47.  
  48.      _----_ffff   Normally, _pppp_gggg splits lines longer than the screen width at
  49.           characters, but some sequences of characters in the text being
  50.           displayed (for example, escape sequences for underlining) generate
  51.           undesirable results.  The _----_ffff option inhibits _pppp_gggg from splitting
  52.           lines.
  53.  
  54.      _----_nnnn   Normally, commands must be terminated by a _n_e_w_l_i_n_e character.  This
  55.           option causes an automatic end of command as soon as a command
  56.           letter is entered.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppgggg((((1111))))                                                                    ppppgggg((((1111))))
  71.  
  72.  
  73.  
  74.      _----_pppp _s_t_r_i_n_g
  75.           Causes _pppp_gggg to use _s_t_r_i_n_g as the prompt.  If the prompt string
  76.           contains a _%%%%_dddd, the first occurrence of _%%%%_dddd' in the prompt will be
  77.           replaced by the current page number when the prompt is issued.  The
  78.           default prompt string is ``_::::''.  _s_t_r_i_n_g may contain supplementary
  79.           code set characters.
  80.  
  81.      _----_rrrr   Restricted mode.  The shell escape is disallowed.  _pppp_gggg will print an
  82.           error message but does not exit.
  83.  
  84.      _----_ssss   Causes _pppp_gggg to print all messages and prompts in standout mode
  85.           (usually inverse video).
  86.  
  87.      _++++_l_i_n_e_n_u_m_b_e_r
  88.           Start up at _l_i_n_e_n_u_m_b_e_r.
  89.  
  90.      _++++_////_p_a_t_t_e_r_n_////
  91.           Start up at the first line containing the regular expression
  92.           pattern.
  93.  
  94.      The responses that may be typed when _pppp_gggg pauses can be divided into three
  95.      categories: those causing further perusal, those that search, and those
  96.      that modify the perusal environment.
  97.  
  98.      Commands that cause further perusal normally take a preceding _a_d_d_r_e_s_s, an
  99.      optionally signed number indicating the point from which further text
  100.      should be displayed.  This _a_d_d_r_e_s_s is interpreted in either pages or
  101.      lines depending on the command.  A signed _a_d_d_r_e_s_s specifies a point
  102.      relative to the current page or line, and an unsigned _a_d_d_r_e_s_s specifies
  103.      an address relative to the beginning of the file.  Each command has a
  104.      default address that is used if none is provided.
  105.  
  106.      The perusal commands and their defaults are as follows:
  107.  
  108.      (+1)<_n_e_w_l_i_n_e> or <_b_l_a_n_k>
  109.           This causes one page to be displayed.  The address is specified in
  110.           pages.
  111.  
  112.      (+1) _llll
  113.           With a relative address this causes _pppp_gggg to simulate scrolling the
  114.           screen, forward or backward, the number of lines specified.  With an
  115.           absolute address this command prints a screenful beginning at the
  116.           specified line.
  117.  
  118.      (+1) _dddd or _^^^^_DDDD
  119.           Simulates scrolling half a screen forward or backward.
  120.  
  121.      _i_ffff   Skip _i screens of text.
  122.  
  123.      _i_zzzz   Same as _n_e_w_l_i_n_e except that _i, if present, becomes the new default
  124.           number of lines per screenful.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppgggg((((1111))))                                                                    ppppgggg((((1111))))
  137.  
  138.  
  139.  
  140.      The following perusal commands take no _a_d_d_r_e_s_s.
  141.  
  142.      _.... or _^^^^_LLLL
  143.           Typing a single period causes the current page of text to be
  144.           redisplayed.
  145.  
  146.      _$$$$    Displays the last windowful in the file.  Use with caution when the
  147.           input is a pipe.
  148.  
  149.      The following commands are available for searching for text patterns in
  150.      the text.  The regular expressions described in _eeee_dddd(1) are available.
  151.      They must always be terminated by a _n_e_w_l_i_n_e, even if the -_n option is
  152.      specified.
  153.  
  154.      _i_////_p_a_t_t_e_r_n_////
  155.           Search forward for the _ith (default _i=1) occurrence of _p_a_t_t_e_r_n.
  156.           Searching begins immediately after the current page and continues to
  157.           the end of the current file, without wrap-around.
  158.  
  159.      _i_^^^^_p_a_t_t_e_r_n_^^^^
  160.      _i_????_p_a_t_t_e_r_n_????
  161.           Search backwards for the _ith (default _i=1) occurrence of _p_a_t_t_e_r_n.
  162.           Searching begins immediately before the current page and continues
  163.           to the beginning of the current file, without wrap-around.  The ^
  164.           notation is useful for Adds 100 terminals which will not properly
  165.           handle the ?.
  166.  
  167.      After searching, _pppp_gggg will normally display the line found at the top of
  168.      the screen.  This can be modified by appending _mmmm or _bbbb to the search
  169.      command to leave the line found in the middle or at the bottom of the
  170.      window from now on.  The suffix _tttt can be used to restore the original
  171.      situation.
  172.  
  173.      The user of _pppp_gggg can modify the environment of perusal with the following
  174.      commands:
  175.  
  176.      _i_nnnn   Begin perusing the _ith next file in the command line.  The _i is an
  177.           unsigned number, default value is 1.
  178.  
  179.      _i_pppp   Begin perusing the _ith previous file in the command line.  _i is an
  180.           unsigned number, default is 1.
  181.  
  182.      _i_wwww   Display another window of text.  If _i is present, set the window
  183.           size to _i.
  184.  
  185.      _ssss _f_i_l_e_n_a_m_e
  186.           Save the input in the named file.  Only the current file being
  187.           perused is saved.  The white space between the _ssss and _f_i_l_e_n_a_m_e is
  188.           optional.  This command must always be terminated by a _n_e_w_l_i_n_e, even
  189.           if the -_n option is specified.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ppppgggg((((1111))))                                                                    ppppgggg((((1111))))
  203.  
  204.  
  205.  
  206.      _hhhh    Help by displaying an abbreviated summary of available commands.
  207.  
  208.      _qqqq or _QQQQ
  209.           Quit _pppp_gggg.
  210.  
  211.      _!!!!_c_o_m_m_a_n_d
  212.           _C_o_m_m_a_n_d is passed to the shell, whose name is taken from the _SSSS_HHHH_EEEE_LLLL_LLLL
  213.           environment variable.  If this is not available, the default shell
  214.           is used.  This command must always be terminated by a _n_e_w_l_i_n_e, even
  215.           if the -_n option is specified.
  216.  
  217.      At any time when output is being sent to the terminal, the user can hit
  218.      the quit key (normally CTRL-\) or the interrupt (break) key.  This causes
  219.      _pppp_gggg to stop sending output, and display the prompt.  The user may then
  220.      enter one of the above commands in the normal manner.  Unfortunately,
  221.      some output is lost when this is done, because any characters waiting in
  222.      the terminal's output queue are flushed when the quit signal occurs.
  223.  
  224.      If the standard output is not a terminal, then _pppp_gggg acts just like _cccc_aaaa_tttt(1),
  225.      except that a header is printed before each file (if there is more than
  226.      one).
  227.  
  228. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  229.      The following command line uses _pppp_gggg to read the system news:
  230.  
  231.           _nnnn_eeee_wwww_ssss _|||| _pppp_gggg _----_pppp _""""_((((_PPPP_aaaa_gggg_eeee _%%%%_dddd_))))_::::_""""
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ppppgggg((((1111))))                                                                    ppppgggg((((1111))))
  269.  
  270.  
  271.  
  272. FFFFIIIILLLLEEEESSSS
  273.      _////_uuuu_ssss_rrrr_////_ssss_hhhh_aaaa_rrrr_eeee_////_llll_iiii_bbbb_////_tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo_////_????_////_****
  274.           terminal information database
  275.      _////_tttt_mmmm_pppp_////_pppp_gggg_****
  276.           temporary file when input is from a pipe
  277.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_cccc_oooo_rrrr_eeee_...._aaaa_bbbb_iiii
  278.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn (5).]
  279. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  280.      _eeee_dddd(1), _gggg_rrrr_eeee_pppp(1), _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4)
  281. NNNNOOOOTTTTEEEESSSS
  282.      While waiting for terminal input, _pppp_gggg responds to BREAK, DEL, and CTRL-\
  283.      by terminating execution.  Between prompts, however, these signals
  284.      interrupt _pppp_gggg's current task and place the user in prompt mode.  These
  285.      should be used with caution when input is being read from a pipe, since
  286.      an interrupt is likely to terminate the other commands in the pipeline.
  287.      The terminal _////, _^^^^, or _????  may be omitted from the searching commands.
  288.      If terminal tabs are not set every eight positions, undesirable results
  289.      may occur.
  290.      When using _pppp_gggg as a filter with another command that changes the terminal
  291.      I/O options, terminal settings may not be restored correctly.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.